FBHFSV Evolve! Welcome to Evolve!. This is a structure editor that empowers programmers to modify programs more efficiently. Evolve! works with outlines that it transforms into source code. All the menus are accessed by pressing Alt-Z, where Z is the first letter of the menu. For example, the "File" menu is pulled down by Alt-F. Y You can get help on any menu item by highlighting that item and pressing [F1] for help. ) Press ESC to put this help screen away. File (Alt-F) The File menu offers choices for opening files, changing directories, and exiting the program. $ Open Change Dir FExit File Open (F3) The Open command displays the Open a File dialog box. In this dialog box you select the data file you want to use. & The Open File dialog box contains: an input box with a history list a list box to browse the directory the standard Cancel button Open action button an information panel that describes the selected file File Change Dir... Change Dir brings up the Change Directory dialog box, in which you can change the current directory. File Exit (Alt-X) The Exit command terminates this program. Window (Alt-W) The Window menu contains commands to close, move and perform other window-management commands. Most of the windows in this program have all the standard window elements, including scroll bars, a close box, and zoom icons. > For more about windows and their elements, refer to windows. : Window-management commands Size/Move Zoom Tile Cascade Next Previous Close Window Size/Move (Ctrl-F5) Choose this command to change the size or position of the active window. Size If you press Shift while you use the arrow keys, you can change the size of the active window. Once you've adjusted its size or position, press Enter. Q If a window has a Resize corner, you can drag that corner to resize the window. Move When you choose Window Size/Move, the active window moves in response to the arrow keys. Once you've moved the window to where you want it, press Enter. F You can also move a window by dragging its title bar with the mouse. Window Zoom (F5) Choose Zoom to resize the active window to the maximum size. If the window is already zoomed, you can choose this command to restore it to its previous size. { You can also double-click anywhere on the window's title bar (except where an icon appears) to zoom or unzoom the window. Window Tile Choose Window Tile to tile all windows on the desktop. L Tiled Windows Window Cascade Choose Window Cascade to stack all file viewers on the desktop. A Cascaded Windows Window Next Choose Next to cycle forwards through the windows on the desktop. Window Previous Choose Previous to cycle backwards through the windows on the desktop. Window Close (Alt-F3) Choose Close to close the active window. O You can also click the Close box in the upper right corner to close a window. Help on Open a File Dialog Box The Open a File dialog box contains an input box, a file list, a file information panel, the standard button Cancel, one other action button (Open), plus a history list that's attached to the Name inputbox. Name The Name input box is where you enter the name of the file to load, or the file-name mask to use as a filter for the Files list box (for example, *.*). Files FILENM01.MNT FILENM09.MNT FILENM02.MNT FILENM10.MNT FILENM03.MNT FILENM11.MNT FILENM04.MNT FILENM12.MNT FILENM05.MNT .. FILENM06.MNT \MOREXAMP FILENM07.MNT \YOURS FILENM08.MNT \ANSWERS.DIR The Files list box lists the names of files in the current directory that match the file-name mask in the Name input box, plus the parent directory and all subdirectories. C:\Evolve!\EXAMPLES\*.MNT HELLO.MNT 152 Jan 14,1992 12:00pm The File information panel shows the path name, file name, date, time, and size of the selected file. = None of the items on this information panel are selectable. [ Open ] The Open button opens a new Viewer window and places the selected file in that window. [ Cancel ] If you choose Cancel, nothing changes and no action occurs, and the dialog box is put away. M (Esc always cancels a dialog box, even if a Cancel button does not appear.) [ Open ] In the Open a File dialog box, if you choose the Open button Evolve! opens a new window and places the selected file in that window. Help on the Change Directory dialog box The Change Directory dialog box consists of an input box, a list box, the standard OK and Help buttons, and two other buttons (Chdir and Revert). | Directory Name The Directory Name input box is where you type in the path of the new directory. Directory Tree Drives C:\ Evolve! EXAMPLES The Directory Tree list box enables you to navigate directories by using the selecting bar and pressing Enter. z Press Enter to make the selected directory be the current directory, then choose OK or press Esc to exit the dialog box. + [Chdir ] The Chdir button changes the current directory once you've 3selected or typed in a directory name. + [Revert] The Revert button goes back to the previous directory, as long as you haven't yet exited the dialog box. Move Cursor Search (Alt-S) Search will open a dialog box where you can enter a target string, search scope, direction of search, and whether to use case sensitivity. Evolve! will then search for the next occurence of that text and make that occurence the current line. File Save (F2) Saves the outline in the current window to a data file. Edit Tree to Clip board Copies a subtree from the current window to the clip board. If the clip board is not open yet, Evolve! will open it. Relocate Tree to Clip Board Removes a subtree from the current window and inserts it under the current line in the clip board. Evolve! opens the clip board if it needs to do so. Relocate Tree from Clip Board Removes the current subtree from the clip board and inserts it under the current line in the current window. Edit Delete Current Tree Erases the current subtree in the current window. Move Cursor This menu enables you to move the highlighted bar, selecting a new line as the current one. Move Cursor Up a Line Select the line above as the current one. Move Cursor Down a Line Select the line below as the current one. File Save as Enables you to save an outline to a file name other than the one shown as the title of the window. Only the part of the outline descendent from the current line is saved to the file. If you want to save the whole outline, move the cursor to the first line of the outline with Ctrl-Home. # cursor|First line File|Save File Print Prints the part of the outline descendant from the current line. Edit Add a Line As a child of current line Creates a new line and makes it a child of the current line. This new line becomes the current line. Edit Add a Line As a sibling of current line Creates a new line and inserts it as a sibling of the current line. This new line becomes the current line. Node Add Branch Creates a new node and inserts it as the parent, or the root of the current node. Edit Add a line As first line Creates a new first line and makes the old first a child of the new first. Edit Current line to clip board Copies a line from the current window to the clip board. The children of the line (if any) are not copied. If the clip board is not open yet, Evolve! will open it. Relocate Items Line to clip board Cuts an line from the current window and inserts it in the clip board. If the line has children, the line's parent will adopt them. If the clip board is not open yet, Evolve! will open it. Relocate Items Line from clipboard Takes a line from the clip board and inserts it in the current window. If the line has children, the line's parent will adopt them. If the clip board is not open yet, Evolve! will open it. Edit Delete Current line Deletes the current line from the current window. If the line has children, the line's parent will adopt them. Relocate Items Sort children of current Sorts the siblings, under one branch, in either ascending or descending order. Relocate Items Tree up/Down Moves the current subtree up or down by switching its position with the sibling above or below. File Import File Print Print the outline (that is descendant from the current line) to a file. The users enters a file name through a dialog box. Tree This menu contains ways to manipulate an Node, including its descendents. Window Open Clipboard Opens a window for the clip board. Marking Reference Marked Lines Use this command to reference all marked lines. Marking Mark/Unmark line If the current line is unmarked, this command marks it. If the current line is marked, this command unmarks it. Tree Push Reference Replaces all references of the current line with copies that have referenced children. Move cursor Go To Line # Moves to the selected line number. File Print to File Prints the outline (descendant from the current line) to a file. Move Cursor Jump to Mark Selects one of the Marked lines as the current line. Move Cursor To Child Displays a scrollable picklist of children. The text of each child is shown as it would be reported, but preceded by the line number. The picklist enables the user to select one of the current line's children as the current line. Move Cursor To Parent Displays a scrollable picklist of parent. The text of each child is shown as it would be reported, but preceded by the line number. The picklist enables the user to select one of the current line's parent as the current line. Move Cursor To Sibling Displays a scrollable picklist of sibling. The text of each child is shown as it would be reported, but preceded by the line number. The picklist enables the user to select one of the current line's sibling as the current line. Edit Add a Line as parent of current line Creates a new line and inserts it as the parent of the current line. Move Cursor Go To Basis Go to the Basis. When a line is referenced, only one instance shows the children explicitly. The instance that shows the children is the basis. Move Cursor First Line Go to the first line in the outline. Move Cursor Last Line Go to the last line in the outline. Edit Marked lines to under current Copy marked lines to under current line. Edit Marked Trees to under current Copy marked trees to under current line. Edit Display Hide children Hide the children of the current line. Edit Display Show children of current Show the kids of the current line. Relocate Marked lines to under current Relocate marked lines to under current. Edit Undo changes to current Undo the changes to the current line. This only has an effect if the cursor has not moved off the line since the changes were made. Edit Display Select Display Style Select the style with which the outline is displayed. EVOLVE! provides four styles for outlines: n 1. A conventional outlining style. 2. A numbered list style. 3. Blanks only. 4. Line drawing characters. ( Below are examples of the four styles. # Outline Title I. First Main topic A. First Subtopic 1. First sub-sub-topic i) Minor topic a) Minor point 1) Sub-minor point 2) Another sub minor point b) Another minor point ii) Another minor topic 2. Second sub-sub-topic B. Second subtopic II. Second main topic # Outline Title 1. First Main topic 1. First Subtopic 1. First sub-sub-topic 1. Minor topic 1. Minor point 1. Sub-minor point 2. Another sub minor point 2. Another minor point 2. Another minor topic 2. Second sub-sub-topic 2. Second subtopic 2. Second main topic Outline Title ' First Main topic First Subtopic First sub-sub-topic Minor topic Minor point Sub-minor point Another sub minor point Another minor point Another minor topic Second sub-sub-topic Second subtopic Second main topic Outline Title |-First Main topic | |-First Subtopic | | |-First sub-sub-topic | | | |-Minor topic | | | | |-Minor point | | | | | |-Sub-minor point | | | | | `-Another sub minor point | | | | `-Another minor point | | | `-Another minor topic | | `-Second sub-sub-topic | `-Second subtopic `-Second main topic File Report Prints a report to a file with the same name but with the extension 'RPT'. The report is produced by processing the outline. The blank display style used so no line drawing characters, roman numerals, or numbering will be put into the report file by EVOLVE!. EVOLVE! will look for the ":>" to define text to print after its children. The first ":>" starts the string that EVOLVE! appends to the end of each terminal descendant except the last terminal descendant. The second ":>" string defines the string that EVOLVE! appends to the end of the last terminal descendant. A terminal descendant is the last child itself if there are no children of the last child. Otherwise, the terminal descendant is the terminal descendant of the last child. File Import ASCII FIle Reads an ASCII file and transforms it into an outline. This is the complement of Report. Marking Unmark all lines Unmarks all marked lines. Marking Mark if Found Marks the first line found that contains the substring you specify. Move Cursor Go to any report line Displays the report text and enables you to move to the outline entry that corresponds to the reported line. Relocate Move tree left Move tree left moves the current line and all its descendants such that its grandparent becomes its new parent. Relocate Move tree Right Move tree right moves the current line and all its descendants such that its nearest sibling above it becomes its new parent. Marking Search,Extract,Mark/Reference This command creates links for all the occurances of an identifier by performing the following steps in sequence: > 1. Opend a dialog box where the user enters A. A target string to search for and act on B. the scope of the search C. the direction of the search D. whether to use case sensitivity 2. Search for the string and, with the users consent: A. Mark one occurance 1. extract the string from its line, replacing it with '<^>' 2. create a new line with only the target string in it 3. Position the new line such that a report will replace the '<^>' with the target string B. Reference the other occurances 1. extract the string from its line, replacing it with '<^>' 2. reference the marked line 3. Position the new line such that a report will replace the '<^>' with the target string Move cursor Go to descendant's report line Displays the report text of the descendants of the current line and enables you to move to the outline entry that corresponds to the reported line. Edit Display Show all children Show all the lines of the outline. Press the [Enter] or return to get out of the "about" window. Press [Escape] to get out of this help window. Move cursor Page Up/Down Scrolls the contents of the current outline up/down one window. Edit This menu has choices that enable the user to change the outline and the outlines appearance. / Add Copy Delete Display Undo Copy Copy line(s) or tree(s) to the current line or clipboard. s Current clipboard Current clipboard Marked lines under current Marked trees current Delete Current Current Display Change the way the outline is viewed in the window. b Hide children current Show children current Show children Select display style Add a line Add a new line to the outline s child current sibling current parent current first Marking Mark and/or reference lines in the outline q Mark/unmark Reference marked lines Unmark lines Mark found Search,Extract,Mark/Reference